home *** CD-ROM | disk | FTP | other *** search
/ Inside Mac Games Volume 3 #6 / IMG 28 June 1995.iso / Shareware / JSokoban 1.0 Folder / JSokoban Doc < prev    next >
Text File  |  1995-01-13  |  5KB  |  70 lines
  1.                                                 JSokoban 1.0
  2.                                                 ©1995 Jason Townsend
  3.  
  4. How to play
  5.  
  6. “Sokoban” is Japanese for “warehouse keeper”. The object of the game is to rearrange the money bags to their destination positions on each level. Winning the game involves solving all the levels.
  7.  
  8. The man responds to the mouse or keyboard. Keyboard movement uses the arrow keys, the numeric keypad, or i-j-k-l. K, comma, spacebar, 5, 2, and 0 all move the man down. Clicking with the mouse in a neighbor square has the same effect as pressing keys. Each move must be either vertical or horizontal; no diagonal moves are allowed.
  9.  
  10. Holding down shift while pressing one of the directional keys or clicking in the same row or column as the man will make the man move in that direction as far as he can. Holding down control will make the man move as far as he can without pushing any bags.
  11.  
  12. The man can move the money bags by pushing them in front of himself, one at a time. If you push a bag into a corner, it is stuck. When you mess up (which will happen more than you think) you can restart the level, or undo the last push. Undo is supported for every push on the current level. To get an idea of the general strategy, try out the level 1 demo (under the File menu). You can speed up the demo by holding down the option key, or stop it by pressing command-period.
  13.  
  14. If you click the mouse somewhere more than one square away, the man will move to where you clicked if there is a path. When you click somewhere you can’t go, JSokoban will play the “bonk” sound. You can drag the man around, too.
  15.  
  16. Pressing the diagonal keys (7, 9, 1, and 3 or U, O, M, and period) is equivalent to clicking on the analogous square immediately diagonal from the man.
  17.  
  18. Sokoban History
  19.  
  20. The original Sokoban won a Japanese computer game contest in the early 80’s. It became a commercial game on NEC computers. (Info from Takeshi Miyazaki.)
  21.  
  22. Much later, a version for Unix (Curses) materialized (author unknown). The 40 “Extra” levels are from xsokoban, by Andrew Myers (andru@lcs.mit.edu). The 50 “Default” levels are the same over all Sokoban versions. (Info from Ingemar Ragnemalm, Scott Lindhurst.)
  23.  
  24. There are two other Sokobans for the Mac, MacSokoban by Ingemar Ragnemalm (ingemar@isy.liu.se) and Sokoban by Scott Lindhurst (lindhurs@math.wisc.edu).
  25.  
  26. Requirements
  27.  
  28. JSokoban should run under System 6.0.7 or later in color, grayscale or B&W. System 7 is recommended for non-68000 machines. For best display of the graphics, use 8-bit color or better. Sound Manager 3.0 or System 7.5 or later is required for multichannel sound. My goal is to make JSokoban support as many setups as possible, so if it doesn’t work on your Mac, let me know!
  29.  
  30. Distribution
  31.  
  32. JSokoban is freeware. As a starving computer engineering student/Mac programmer, I understand tight software budgets. :) So send me mail instead of money. Any distribution of JSokoban must be non-profit, and include this doc file, the “Extra” file, and the “Bug Report” file. Although JSokoban is freeware, the game (minus the included levels) is ©1995 Jason Townsend.
  33.  
  34. Acknowledgements
  35.  
  36. Several people have contributed to the development of this game. Charles Turner explained many Mac pascal concepts to me, including type-casting. Ryan Schmidt demanded B&W/System 6 support, so I had to oblige him. Both Ryan and Charles had good suggestions for new features or better ways of doing old things. (And bug reports too!)
  37.  
  38. Jason Best created the awesome graphics that replaced my clunky originals.
  39.  
  40. I would also like to thank my beta testers Ryan Schmidt, Jason Best, Ben Judson, Charles Turner, Alex Kac, John Fenton, Scott Lindhurst, and Florian Keller.
  41.  
  42. JSokoban was written in THINK Pascal 4.0.2 on an LC 575 12/540.
  43.  
  44. How to Contact Me
  45.  
  46. Please send me any comments, suggestions, or (heaven forbid) bug reports. I can be reached at the following addresses:
  47.  
  48. Internet: 
  49.      JasonTownsend@mail.utexas.edu
  50.  
  51. Snail mail:
  52.      Jason Townsend
  53.      6306 Sunview
  54.      San Antonio, TX 78238
  55.  
  56. Future plans for JSokoban: (in approximate order of priority)
  57. • PowerPC native code. (requires porting to CodeWarrior)
  58. • Chunk updates in color.
  59. • Open/convert MacSokoban external level files. (Possibly in an external level editor.)
  60. • Preserve modification dates when saving current level and window position information.
  61. • Move/push counting with low move/push records. (like MacSokoban)
  62. • Animation.
  63. • Simple balloon help/online help.
  64. • Import/export levels to/from text files (like MacSokoban).
  65. • Level editor.
  66. • Levels that are unique to JSokoban.
  67. • Option to change movement key settings (not sure if this is necessary).
  68. • Soundtrack.
  69. • 3D, texture-mapped first person view of the maze.
  70.